home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / tcp_ip / gp / 7plus.fra < prev    next >
Text File  |  1992-01-02  |  34KB  |  805 lines
  1.  
  2.  ***************************************************************
  3. ***                                                           ***
  4. *** 7PLUS - Un nouvel et efficace encodeur/décodeur pour le   ***            
  5. ***         transfert de données sur le réseau packet-radio.  ***
  6. ***                                                           ***
  7. *** Version 1.5   Axel BAUDA, DG1BBQ @ DB0CL.DEU.EU           ***
  8. ***   25/09/91           Postdamer Str. 43                    ***
  9. ***                    W-2850 Bremerhaven 21                  ***
  10. ***                          GERMANY                          ***
  11. ***                                                           ***
  12. *** 7PLUS est du Domaine Publique. Il peut être copié         ***
  13. *** gratuitement. Les fichiers .DOC et 7PLUS.C doivent être   ***
  14. *** inclus! Ce document est valable pour la version PC ainsi  ***
  15. *** que pour les versions AMIGA, ATARI-ST et UNIX.            ***
  16.  ***************************************************************
  17.  
  18. La "phobie-de-la-non-lecture-de-doc." (phobieantidoc):
  19. ======================================================
  20.  
  21. Cela se produit à chaque fois. Les utilisateurs me posent des questions
  22. dont la réponse et le sujet sont clairement expliqués dans le manuel.
  23.  
  24. Je sais, il est parfois difficile pour certains de lire soigneusement le
  25. manuel mais cette lecture attentive m'épargne un temps précieux. Donc en
  26. cas de problèmes, lisez attentivement le manuel.
  27.  
  28. J'ai essayé de rédiger ce manuel avec un maximum de détails, néanmoins
  29. je peux avoir oublié certaines choses de çi de là.
  30.  
  31. Personne n'est parfait....
  32.  
  33. Je ne peux vous donner ici un cours complet sur le MS-DOS/ATARI/AMIGA ou
  34. UNIX. Donc vous devrez avoir les connaissances de bases de votre système
  35. informatique.
  36.  
  37. Et, aussi connaitre les commandes de votre logiciel de communications.
  38.  
  39. Préface:
  40. ========
  41.  
  42. Tous les encodeurs actuels comme 7BIT, RADIX95, UUENCODE et SEVEN 
  43. ne prennent pas en considération que les fichiers transmis 
  44. puissent être abimés lors des transferts sur réseau packet-radio. 
  45. Jusqu'à ce jour, les fichiers abimés devaient être répetés, 
  46. parfois à de nombreuses reprises, avant de parvenir à les 
  47. transmettre sans erreurs et ce parfois sans succès.
  48.  
  49. C'est ici que 7PLUS entre en jeu en offrant la possibilité de 
  50. réparer les fichiers abimés en n'importe quel point du réseau et 
  51. ce sans devoir retransmettre le fichier complet.
  52.  
  53. L'automation et la détection fiable des lignes abimées sont 
  54. rendus possibles grâce au CRC et à la numérotation des lignes 
  55. encodées.
  56.  
  57. Un exemple: FE6EQZ a encodé le fichier TEST.EXE en TEST.7PL et 
  58. transféré ce fichier sur un serveur. 
  59.  
  60. F6ABJ retire ce fichier du serveur et tente de le décoder. 
  61.  
  62. ...Malheureusement, ce fichier a été abimé lors du transfert. 
  63.  
  64. 7PLUS détecte les lignes erronées et crée un rapport d'erreurs appelé 
  65. TEST.ERR. 
  66.  
  67. F6ABJ envoie ce fichier TEST.ERR à FE6EQZ, ce dernier saura alors créer le 
  68. fichier de correction TEST.COR grâce à 7PLUS. 
  69.  
  70. FE6EQZ télécharge TEST.COR sur le serveur à destination de F6ABJ. 
  71.  
  72. Pour autant que F6ABJ reçoive TEST.COR sans erreurs (sinon il faut 
  73. recommencer l'envoi de TEST.COR), le fichier TEST.7PL sera corrigé et 
  74. décodé avec succès. 
  75.  
  76. Au cas où TEST.7PL contient plus d'erreurs que les corrections dans 
  77. TEST.COR, il suffit de générer un nouveau fichier TEST.ERR et de répéter
  78. la procédure décrite plus haut. Ceci est de loin plus efficace que de
  79. renvoyer le fichier entier.
  80.  
  81. Je dois admettre que le procédé semble compliqué à première vue 
  82. mais ce n'est vraiment pas le cas en réalité. La description de 
  83. la procédure est la réalisation de trois étapes:
  84.  
  85.  ' Détection des erreurs'
  86.  ' Rapport vers l'expéditeur et demande de correction'
  87.  ' Correction des erreurs'
  88.  
  89. Une fois que vous aurez compris le processus et effectué quelques 
  90. essais, vous verrez que ce n'est vraiment pas compliqué.
  91.  
  92.  
  93. Historique de 7PLUS:
  94. ====================
  95.  
  96. 7PLUS a été développé au départ de mon précédent encodeur SEVEN.
  97. La faculté de corrections a provoqué une incompatibilité entre SEVEN et
  98. 7PLUS, cela a été le prix à payer. Ce n'est pas si grave, vu les avantages
  99. de 7PLUS comparés à SEVEN. Les rediffusions de fichiers abimés lors
  100. du transfert en réseau, sont du passé. Etant donné l'icompatibilité de
  101. SEVEN et 7PLUS, j'ai inclus l'algorithme RADIX216 comme encodage compact 
  102. des fichiers.
  103. Au début, il y a eu une très forte opposition à 7PLUS. Certains étaient
  104. convaincus qu'un encodeur utilisant les caractères au-delà de 7Fh allait
  105. provoquer plus de mal que de bien. 7PLUS s'est imposé comme l'encodeur 
  106. de REFERENCE en Allemagne. Ceci donne tort aux opposants. A l'heure 
  107. actuelle, 7PLUS est non seulement en usage en Allemagne, mais dans toute
  108. l'Europe. On trouve même des partisans de 7PLUS au Japon. Il y a même des
  109. BBS's qui utilisent 7PLUS dans leur fonction serveur.
  110.  
  111. Comment fonctionne l'encodage de 7PLUS ? (en résumé)
  112. ====================================================
  113.  
  114. 7PLUS utilise un algorithme RADIX 216 d'encodage qui ne provoque 
  115. qu'un accroissement de la taille du fichier de 3.23% seulement. 
  116. Cet algorithme encode 31 bytes en 32 bytes ASCII. Cet algorithme 
  117. pourrait être aussi appelé 7-3/4-bit-encoding, parce que chaque
  118. digit représente autant de bits des données non-encodées. Voilà 
  119. pourquoi le nom 7PLUS a été utilisé. En plus on ajoute 
  120. un CRC et un numéro ligne par ligne, une séparation de ligne 
  121. ainsi qu'un préambule et une conclusion. Ces ajoutes n'augmentent 
  122. le fichier que de 11 à 12%.
  123.  
  124. Augmentation d'autres encodeurs/décodeurs:
  125.  
  126.  RADIX95 : 24%
  127.  UUCODE  : 42%
  128.  
  129.  Chaque caractère du codage sera compris entre 0 et 215.
  130.  Cette plage ne peut être transmise directement (elle contient
  131.  des caractères de contrôle), le code est transposé afin d'éviter
  132.  des tas de problèmes.
  133.  
  134. Table de codage:
  135.  
  136.      21h - 29h, 2Bh - 7Eh, 80h - 90h, 92h, 94h - FCh (compris).
  137.  
  138. Valeurs éliminées volontairement:
  139.  
  140.      00h - 20h: caractères de contrôles et espace.
  141.                 Certains terminaux éliminent les espaces en fin
  142.                 ligne!
  143.  
  144.      2Ah      : Astérisque, peut provoquer des problèmes sur
  145.                 certains serveurs. (p.ex.:'*** end')
  146.  
  147.      7Fh      : DEL, un autre caractère de contrôle.
  148.  
  149.      91h + 93h: Certains terminaux téléphoniques interprètent ces
  150.                 valeurs comme XON et XOFF....raison inconnue???
  151.                 Probablement une erreur.
  152.  
  153. Le seul problème avec des fichiers encodés sous 7PLUS est le fait 
  154. que des caractères au-delà de 7Fh sont utilisés. Certains 
  155. logiciels n'interprètent pas correctement ces caractères. Par 
  156. expérience en Allemagne et dans les pays voisins, il a été 
  157. constaté que les serveurs (TheBox, W0RLI, F6FBB, AA4RE....) ainsi que la 
  158. plupart des logiciels de communications sont capables de digérer 
  159. ces caractères. Déjà certains logiciels sont mis à jour afin de 
  160. travailler correctement sous 7PLUS. Les TNC's ne posent pas de 
  161. problèmes, parce qu'ils savent être configurés afin de traiter 
  162. les caractères au-delà de 7Fh (8BITCONV ON, AWLEN 8....).
  163. Cela ne sera plus long avant que la majorité des programmes de 
  164. communications packet soient capable de travailler correctement 
  165. sous 7PLUS. Si 7PLUS se développe comme c'est le cas en 
  166. Allemagne, les auteurs de logiciels suivront (devront suivre) le 
  167. mouvement de réduction de la quantité de données à transmettre 
  168. sur réseau.
  169.  
  170.  
  171. Comment sont constitués les fichiers 7PLUS ?
  172. ============================================
  173.  
  174. Les fichiers 7PLUS débutent toujours par une ligne de préambule, 
  175. suivi de 512 lignes de code et d'une ligne de conclusion 
  176. indiquant la fin du fichier. Toutes les lignes sont transmises 
  177. avec un séparateur de ligne, ce signe est le caractère CR (retour 
  178. chariot).
  179. Sur disque, ce séparateur de ligne doit être conforme aux 
  180. différents systèmes (CR/LF sur IBM-PC et ATARI ST, LF sur AMIGA).
  181.  
  182. Le préambule:
  183. -------------
  184.  
  185.  go_7+. 005 of 010 TEST.EXE    0010453 6488 166 (7PLUS v1.4) XXXXY
  186.  └────┘ └─┘    └─┘ └─────────┘ └─────┘ └──┘ └─┘ └──────────┘ └───┘
  187.    1     2      3       4         5      6   7       8         9
  188.  
  189.    1) Départ, dans la deuxième colonne.
  190.    2) Partie 5
  191.    3) de 10 parties.
  192.    4) Nom du fichier encodé + blancs, max. 12 car.
  193.    5) Longueur du fichier encodé.
  194.    6) nombre de bytes ASCII dans cette partie (HEX).
  195.    7) Nom de l'encodeur et version.
  196.    8) Caractère de test (détection du 8ième bit). Aussi utilisé
  197.       pour indiquer que le nom complet apparait dans la ligne
  198.       suivante. Ceci est uniquement le cas avec la version AMIGA.
  199.       De cette façon l'échange de fichiers 7PLUS, créés sur des
  200.       systèmes avec des noms structurés différemment, reste possible. 
  201.    9) XXXX: caractères de test (afin de vérifier le 8ieme bit). Aussi  
  202.       utilisé afin d'indiquer que le nom complet du fichier suit dans
  203.       la ligne suivante (si version 1.4 ou plus). Ceci est uniquement
  204.       le cas avec la version AMIGA/UNIX actuellement. De cette façon
  205.       on garde une compatibilité entre les fichiers créés sur d'autre
  206.       système que MS-DOS.
  207.       Y: Minichecksum pour l'entête (version 1.5 et plus).
  208.  
  209.  
  210. Les lignes de code:
  211. -------------------
  212. AAAAAAAAAAAAAAAAAAAAAA.........BBBBBBBBBBBBBBBBBBBBBBBBBBPPP
  213. └───────────────────────────────────────────────────────┘└─┘
  214.      64 ASCII bytes, représentant 62 bytes binaires       *
  215.  
  216. A: premier groupe (32 bytes ASCII, représentant 31 bytes bin.)
  217. B: second groupe
  218. P: Checksum et numérotation de ligne.
  219.  
  220. Chaque ligne est constituée de 64 bytes ASCII plus 3 bytes, elle 
  221. contient aussi le CRC et le numéro de ligne.
  222.  
  223. Chaque fichier 7PLUS comprend un maximum de 512 lignes de code. 
  224. Si plus sont nécessaires, le fichier sera scindé.
  225.  
  226. En conclusion, chaque fichier 7PLUS peut contenir 512x62 = 31744 
  227. bytes. Avec un maximum de 255 parties, soit 8.094.720 bytes. Ceci 
  228. semble très suffisant pour la plupart des applications.
  229.  
  230.  
  231.  
  232.  
  233.  
  234. La ligne de conclusion:
  235. -----------------------
  236.  
  237.   stop_7+. (TEST.P05)
  238.   └──────┘ └────────┘
  239.       1         2
  240.  
  241.   1) indicateur de fin, dans la deuxième colonne.
  242.   2) Nom du fichier de cette partie
  243.  
  244.  
  245. Les rapports d'erreurs:
  246. =======================
  247.    Si des fichiers 7PLUS ont été endommagés lors du transfert, 7PLUS
  248.    reconnait les erreurs et crée un rapport d'erreurs qui contiendra
  249.    toutes les informations nécessaires afin de créer le fichier de
  250.    correction.
  251.  
  252.    Un fichier d'erreur ressemble à ceci:
  253.  
  254.     go_text. TEST.ERR
  255.    7PLUS error report: TEST.TXT 113 /Test.TXT/ 34028
  256.    01
  257.    005 006 007 03D FFF
  258.    02
  259.    10C 10D 10E FFF
  260.    00
  261.    CRC A17D
  262.     stop_text.
  263.  
  264.    Les lignes 'go_text.' et 'stop_text.' sont utilisées afin de reconnaitre
  265.    et d'extraire le rapport d'erreurs d'un fichier de capture.
  266.  
  267.    La ligne '7PLUS error report...' contient des informations telles que:
  268.  
  269.    Nom du fichier original.
  270.    Longueur des blocks lors de l'encodage,
  271.    le nom complet (seulement AMIGA/UNIX)
  272.    et (à partir de la v1.5) la longueur du fichier original.
  273.  
  274.    La valeur de deux chiffres en hexa donne la partie où les lignes
  275.    indiquées ont été endommagées. Un numéro de ligne 'FFF' indique
  276.    la fin des erreurs de cette partie. '00' indique la fin du fichier
  277.    d'erreurs. A la ligne suivante, un checksum pour le rapport d'erreurs
  278.    (7PLUS v1.5 et plus) confirme le contenu du fichier.
  279.  
  280. Le fichier de corrections:
  281. ==========================
  282.  
  283.    Aprés avoir envoyé le fichier d'erreurs vers l'expéditeur du fichier
  284.    encodé, l'expéditeur du fichier utilisera ce dernier afin de créer le
  285.    fichier de corrections. Ce fichier de corrections contiendra toutes
  286.    les lignes endommagées ou manquantes. Il enverra ce fichier au demandeur
  287.    ou l'enverra vers la BBS où le plus grand nombre d'erreurs aura été
  288.    signalé. Dans ce dernier cas l'option '-J' sera pratique. On peut
  289.    avec cette option joindre plusieurs fichiers de corrections afin de
  290.    créer un fichier reprenant l'ensemble des corrections.
  291.  
  292.    Exemple de fichier de corrections:
  293.     (Contenu des lignes de code abrégé)
  294.  
  295.      go_text. TEST.COR
  296.     7PLUS correction: TEST.TXT 34028
  297.      P01:
  298.      L005:
  299.     sdWKLRjwEK....
  300.      L006:
  301.     "rt4rWER7Z....
  302.      L007:
  303.     eeERG35ERG....
  304.      L03D:
  305.     $%&H$%6TZJ....
  306.      P02:
  307.      L10C:
  308.     AdD$%SFFDr....
  309.      L10D:
  310.     sFG$sFw4rf....
  311.      L10E:
  312.     56fZTddfDg....
  313.      P00:
  314.     CRC A9B6
  315.      stop_text.
  316.  
  317.     'go_text.', 'stop_text.' et checksum: voir 'Le fichier d'erreur'.
  318.  
  319.     La ligne '7PLUS correction...' contient les informations suivantes:
  320.  
  321.     Nom du fichier original
  322.     et (7PLUS v 1.5 et plus) la longueur du fichier original.
  323.  
  324.     Une ligne débutant par ' Pxx:' defini pour quelle partie les lignes
  325.     corrigées sont destinées. Les lignes encodés sont précédées de 'LXXX:'
  326.     ceci indique le numéro de ligne dans le fichier. 'XX' et 'XXX' sont des 
  327.     valeurs hexadécimales.
  328.  
  329.     La structure des fichiers d'erreurs et de corrections sont
  330.     volontairement réduites au plus simple dans un souci de clarté.
  331.  
  332.     Compatibilité des versions 7PLUS:
  333.     =================================
  334.  
  335.     Tous les fichiers des versions anciennes de 7PLUS peuvent être décodées
  336.     par la nouvelle version et vv.
  337.  
  338.     Ceci est aussi valable pour les fichiers d'erreurs et de corrections.
  339.  
  340.     En commencant avec la version 1.5, un checksum est ajouté au fichier
  341.     d'erreurs et de corrections. Il n'est vérifié que si présent. Lorsque
  342.     7PLUS version 1.5 et plus récent travaille sur des fichiers de version
  343.     plus ancienne, un message d'avertissement sera émis indiquant l'absence
  344.     de checksum.
  345.  
  346.     'no CRC. File may be corrupted or from version earlier than 7PLUS v1.5'
  347.  
  348.     Néanmoins, 7PLUS continuera a décodé le fichier. L'avertissement 
  349.     indiquera uniquement que le fichier n'est peut-être pas 100% correct.
  350.     Vous vérifierez visuellement si ces fichiers sont corrects. Etant donné
  351.     la structure simple des fichiers d'erreurs et de corrections ce sera
  352.     facile et on pourra effacer les lignes fautives. Attention, si un 
  353.     checksum est présent, il devra être effacer, sinon le fichier ne sera 
  354.     plus accepté par 7PLUS!
  355.  
  356. Convention d'appellation des fichiers:
  357. ======================================
  358.   
  359.   Les fichiers gérés par 7PLUS, doivent satisfaire aux règles
  360.   d'appelation des fichiers sous MS-DOS, peu importe sur quelle
  361.   système 7PLUS est utilisé. Le nom de fichier comprendra
  362.   toujours un nom (8 caractères max.) et une extension (3 car.
  363.   max.) séparé par un point (.). Les noms de fichiers sous 7PLUS sont
  364.   toujours en majuscules. Sur disque, les minuscules sont utilisés pour
  365.   les noms de fichiers, si le système le permet. Ceci est TRES important
  366.   sur les systèmes qui font la distinction minuscules/majuscules comme
  367.   sur UNIX.
  368.  
  369.   Par ex.: TERMINAL.EXE  
  370.   
  371.   Afin de permettre le transfert des noms complets des fichiers
  372.   structurés de façon différente que sur MS-DOS, les noms complets
  373.   sont transférés séparément (voir "Le préambule"). De même un mom
  374.   de fichier compatible MS-DOS est créé afin de garantir l'inter-
  375.   changeabilité. Le nom complet 'Hyper_Term_Plus' serait modifié en
  376.   'HYPER_TE'.
  377.  
  378.   Lors de l'encodage sans division de fichier. Le fichier encodé
  379.   portera comme extension de nom: '.7PL'.
  380.  
  381.   Les fichiers scindés porteront l'extension '.PXX',où XX est une
  382.   valeur hexa dans la plage de 01h à FFh.
  383.  
  384.   Les rapports d'erreurs auront habituellement l'extension '.ERR" et
  385.   les fichiers de correction auront l'extension '.COR'. Ceci
  386.   est très important, car 7PLUS tire ses infos de travail de ces 
  387.   extensions! Il est permis de changer les noms des fichiers de
  388.   corrections et d'erreurs, néanmoins, l'extension DOIT être
  389.   '.ERR' ou '.COR'. Si vous recevez de multiple fichiers d'erreurs
  390.   il est possible de dénommer autrement les fichiers d'erreurs. Le 
  391.   premier fichier d'erreurs aura comme extension '.err' et les suivants
  392.   auront '.eXX', où XX sera une valeur hexadécimale.
  393.   Exemple: Vous avez reçus trois fichiers d'erreurs en relation avec le
  394.   même fichier original (TEST.7PL). Lors de l'extraction avec l'option
  395.   '-X', le premier fichier d'erreur sera TEST.ERR, le deuxième sera 
  396.   TEST.E01 et le troisième TEST.E02. Les trois fichiers d'erreurs 
  397.   pourront alors être facilement combiné grâce à l'option '-J'.
  398.  
  399.   Les fichiers 7PLUS devront toujours respectés ces principes de
  400.   base. Ceci est de la plus haute importance surtout pour les 
  401.   fichiers scindés et pour les corrections éventuels.
  402.  
  403.   Le nom sous lequel un fichier 7PLUS sera sauvé peut-être trouvé à
  404.   la fin de chaque partie (voir 'La ligne de conclusion').
  405.  
  406.  
  407. Comment utiliser 7PLUS ?
  408. ========================
  409.  
  410.  Encodage:
  411.  ---------
  412.  
  413.  7plus test.exe        Encodage de TEST.EXE. Si le fichier 
  414.                        résultant contient plus de 512 lignes, le
  415.                        fichier sera automatiquement divisés en 
  416.                        partie de 512 lignes.
  417.  
  418.  7plus test.exe -s     Encodage et division, 140 lignes/fichier
  419.                        (env. 10K/fichier)
  420.  
  421.  7plus test.exe -s 30  30 lignes par fichier.
  422.  
  423.  7plus test.exe -sp 3  Encodage et division en 3 fichiers de 
  424.                        taille ± identique
  425.  
  426.  
  427.  Décodage:
  428.  ---------
  429.  
  430.  7plus test.7pl        Décodage. Crée un rapport d'erreurs, si
  431.                        TEST.7PL est abimé.
  432.  
  433.  7plus test.p01        Rassemblage et décodage.
  434.  
  435.  7plus test            Au décodage, l'extension peut être omise.
  436.                        Si 7PLUS trouve TEST.COR il procédera d'abord 
  437.                        à la correction.
  438.                        Si un nom de fichier 'TEST' existe déjà,
  439.                        il sera encodé.
  440.  
  441.  
  442.  Correction:
  443.  -----------
  444.  
  445.  7plus test.err c:\pr\ Compilation d'un fichier de correction
  446.                        TEST.COR et utilisation du fichier
  447.                        TEST.EXE en C:\PR\. 'TEST.EXE' est le
  448.                        fichier original qui a été encodé. Il
  449.                        n'est pas nécessaire de conserver les 
  450.                        fichiers encodés mais mais vous devez 
  451.                        conserver le fichier original (TEXT.EXE)
  452.                        afin de vous permettre de répondre aux
  453.                        demandes de corrections!
  454.                        Une situation particulière apparait lors
  455.                        de la création d'un fichier sur un sys-
  456.                        tème utilisant des noms ne respectant pas
  457.                        la norme MS-DOS.
  458.                        Exemple:
  459.                        Un OM encode 'Hyper_Term_plus' sur un 
  460.                        AMIGA. 7PLUS va donner le nom, compatible
  461.                        MS-DOS, 'HYPER_TE' (Le nom complet sera 
  462.                        transmis aussi dans le fichier, mais la  
  463.                        version PC et ATARI-ST ne le fera pas). Si
  464.                        quelqu'un décode le fichier avec une version
  465.                        ancienne de 7PLUS (avant 1.4) et que des 
  466.                        erreurs apparaissent, le fichier 'HYPER_TE.ERR'
  467.                        sera créé. Si notre OM envoie ce dernier fichier
  468.                        à notre utilisateur d'AMIGA, 7PLUS va tenter de
  469.                        trouver 'HYPER_TE' en créant le fichier de
  470.                        correction et ne le trouvera probablement pas.
  471.                        Dans ce cas, le nom complet et le chemin peuvent
  472.                        être spécifié.
  473.                        Exemple: 
  474.                        7plus hyper_te.err df0:utils/Hyper_Term_Plus 
  475.                        Si 7PLUS v1.4 (ou plus récente) est utilisé, ce
  476.                        problème ne se présentera PAS, parce que le nom
  477.                        original et complet est transmis avec le nom
  478.                        compatible MS-DOS dans le rapport d'erreurs, 
  479.                        même si ce n'est pas évalué autrement sur les 
  480.                        versions PC et ATARI-ST.
  481.                      
  482.  
  483.  7plus test.cor        Répare test.7pl/test.pxx, en utilisant
  484.                        TEST.COR. Il arrive que toutes les erreurs ne
  485.                        soient pas couvertes par le fichier de corrections.
  486.                        Dans ce cas, il faut tenter de décoder et ainsi créer
  487.                        un nouveau fichier d'erreurs. Envoyez ce dernier à
  488.                        l'expéditeur du fichier pour complément de corrections.
  489.  
  490.  7plus test.err test2.err -j
  491.                        Le contenu de test2.err sera ajouté à test.err. Ceci
  492.                        sera très utile lorsque plusieurs fichiers d'erreurs
  493.                        auront été reçu. Attention, un fichier d'erreurs
  494.                        contenant un grand nombre de ligne sera de préférence
  495.                        traité individuellement.
  496.  
  497.  7plus test.err -j     Ceci est procédure particulière de jonction de
  498.                        fichiers d'erreurs. 7PLUS cherchera le fichier
  499.                        test.e01 en premier lieu et ensuite le joindra à
  500.                        test.err, ensuite cherchera test.e02 etc etc...
  501.                        Il est important que les fichiers d'erreurs aient
  502.                        été extrait d'un fichier de capture par l'option
  503.                        '-X'! Après cette action, test.err contiendra
  504.                        toutes les erreurs transmises par les fichiers 
  505.                        d'erreurs.
  506.  
  507.  7PLUS - Extraction des fichiers:
  508.  --------------------------------
  509.  
  510.  7plus fichier de capture text -x
  511.   'extrait' tous les fichiers 7PLUS du fichier de capture et les sauve
  512.   séparément, si un texte est précisé, seul les fichiers contenant ce texte
  513.   dans le titre seront extraits.
  514.  
  515.   p.ex: 7plus spsave.c10 952.err -x
  516.         Extrait tous les rapports d'erreurs contenant '952.err' dans le
  517.         nom de fichier.
  518.  
  519.   Si un texte fictif est défini (p.ex:'###'), aucun fichier ne sera
  520.   extrait, mais par contre vous recevrez une liste des fichiers dans le
  521.   fichier de capture.
  522.                         
  523.   Peu importe le type de séparateur de lignes dans le fichier de
  524.   capture: CR/LF, CR ou LF. Les fichiers extractés auront cependant des
  525.   séparateurs de lignes  conforment au système utilisé. C'est-à-dire 
  526.   CR/LF sur IBM-PC et ATARI ST, LF sur AMIGA/UNIX.De cette façon, pas 
  527.   besoin d'utiliser un éditeur de texte pour "nettoyer" le fichier de 
  528.   capture et de plus les règles de dénomination ds fichiers seront
  529.   respectées.
  530.  
  531.   De plus, les rapports d'erreurs et de corrections seront extraits. 
  532.   Ceci ne fonctionne que si (go_text. et stop_text) sont trouvés.
  533.  
  534.  Autres options:
  535.  ---------------
  536.  -N (version ATARI_ST seulement) Normallement, 7PLUS demande de taper
  537.     sur une touche quelconque à la fin. L'option '-N' supprimera cette
  538.     frappe. Ceci est utile lorsque 7PLUS est invoqué à partir d'un autre
  539.     programme (shell).
  540.  
  541.  -P Les fichiers encodés, les fichiers d'erreurs et de corrections con-
  542.     tientront un CR comme interligne. Ceci est nécessaire lors de l'utili-
  543.     sation de programmes d'émulation de terminal, où les fichiers 7PLUS
  544.     devront être envoyé sous l'option de transfert binaire, parce qu'ils
  545.     n'assimilent pas les caractères sous 8bits en mode texte. Ceci est 
  546.     même tres important sur AMIGA, parce que ce dernier utilise LF comme
  547.     interligne!. Le téléchargement d'un fichier,  avec l'option transfert
  548.     binaire, qui contient des LF comme interlignes va créer un fichier
  549.     inutile parce que les LF sont toujours éliminés. L'interligne standard
  550.     en packet-radio est CR!. Le résultat serait un fichier contenant UNE
  551.     longue ligne!
  552.  
  553.  -T Cette option peut être utilisé pour ajouter un séquence de fin aux
  554.     fichiers encodés, aux fichiers d'erreurs et de corrections.
  555.     Exemple:
  556.             7plus test.exe -sp 2 -p -t /ex
  557.  
  558.  -Y 'YES' par défaut lorsque demandé. Cette option est utile lorsque 7PLUS
  559.     est appelé à partir d'un autre programme (shell, serveur).
  560.  
  561.  -# Cette option est utilisée lorsque 7PLUS est sur un serveur. Lors de
  562.     l'encodage, 7PLUS créera '7plus.fls', ce fichier contiendra le nombre
  563.     de fichiers crées ainsi que le nom compatible MS-DOS.
  564.     p.ex: 10 TEST
  565.  
  566.  Un résumé des commandes est obtenu en tapant 7PLUS sans paramètres.
  567.  
  568.  
  569.  
  570.  Conseils:
  571.  ---------
  572.  
  573.  Assurez-vous que votre tnc/logiciel est capable de traiter le
  574.  set de caractères de 7PLUS (voir tableau plus haut). Il est 
  575.  important de placer tous les paramètres relatifs à 8bits
  576.  correctement (8BITCONV ON, AWLEN 8 ...). Le caractère de changement  
  577.  de canal sera mis à $01 (CTRL-A) parce que 7PLUS utilise tous les
  578.  caractères imprimables. Sinon des changements non-souhaités de canal
  579.  se produiraient, lors du télé-chargement de fichier sous 7PLUS.
  580.  Vérifiez aussi votre câble RS232 (configuration 8 bits).
  581.  
  582.  Si malgré ces précautions vous n'ètes toujours pas en mesure 
  583.  de traiter les fichiers sous 7PLUS, prenez contact avec l'auteur
  584.  de votre logiciel de communications, il y va de son intérêt que
  585.  son programme puisse faire face à toutes les éventualités, je 
  586.  suis persuadé qu'il modifiera son logiciel.
  587.  
  588.  YAPP:
  589.  -----
  590.  Certaines versions anciennes de YAPP élimine le bit 8....
  591.  Utilisez une version plus récente!
  592.  
  593.  BBS non-W0RLI/AA4RE/F6FBB/TheBox:
  594.  ---------------------------------
  595.  Certains de ces logiciels de BBS's élimine le bit 8! Le seul cas m'a
  596.  été signalé en Hongrie. L'auteur de ce logiciel travaille afin de le
  597.  modifier.
  598.  Dans le Royaume-Uni, il y a des bbs's qui coupe les caractères entre
  599.  E0h et FFh. Le problème est connu et la solution recherchée. De plus,
  600.  certaines BBS's élimine le caractère FEh, ceci n'est pas un problème, 
  601.  7PLUS n'utilise pas cette valeur.
  602.  
  603.  Mise en garde: EPROM WA8DED
  604.  ---------------------------
  605.  
  606.  Ne sait pas gérer les fichiers en mode terminal, sauf modifications 
  607.  ou si on utilise l'eprom TheFirmware v2.2a DAMA (NORD><LINK, Germany)
  608.  ou une version plus récente. Etant que cette eprom est destinée à être
  609.  utilisée principalement sous HOST MODE, ceci ne pose pas de problèmes.
  610.  
  611.  7PLUS sur AMIGA:
  612.  ----------------
  613.  
  614.  La plupart des programmes d'émulation de terminal sur AMIGA ne
  615.  savent pas utiliser les fichiers 7PLUS en mode texte. Ceci
  616.  provient du fait que ceux-ci interprètent les caractères de 
  617.  contrôle AMIGA compris entre 80h et 9Fh. Il serait plus sage de
  618.  les afficher en les remplaçant par des caractères qui ne posent
  619.  pas ce genre de probèmes et sans les interpréter comme des 
  620.  caractères de contrôle.
  621.  A cause de cela les fichiers encodés 7PLUS devrait être transmis 
  622.  en mode binaire. La solution est de décoder le fichier en utilisant
  623.  l'option '-X' de 7PLUS. L'édition du fichier de capture n'est
  624.  en ce cas pas nécessaire.
  625.  
  626.  Lors de la capture de fichiers 7PLUS em mode binaire, la 
  627.  séparation de ligne AMIGA (LF) doit être changé en <CR> 
  628.  comme convenu en packet-radio. Ceci est possible en utilisant
  629.  l'option '-p' de 7PLUS.
  630.  
  631.  
  632.  Comment prendre des fichiers 7PLUS sur une BBS:
  633.  ===============================================
  634.  
  635.  Afin de procéder à cette opération, assurez-vous votre tnc/programme
  636.  de communication soient configurés convenablement.
  637.  A cet effet, le fichier ASC.TXT sur le disquette de distribution de
  638.  7PLUS, sera votre test. Transférez ASC.TXT vers la BBS (self-addressé) 
  639.  et retirez le fichier de la BBS. Si ce que vous recevez n'est pas
  640.  identique à l'envoi....vérifiez votre configuration et lisez le 
  641.  chapitre "Conseils".
  642.  
  643.  Si le test est OK, alors vous êtes parés pour travailler avec 7PLUS.
  644.  
  645.  La façon la plus simple de travailler avec 7PLUS est d'ouvrir un fichier
  646.  de capture et d'y déposer tous les fichiers venant de la BBS. Attention,
  647.  n'appellez pas ce fichier d'un nom similaire des fichiers capturés!.
  648.  Utilisez un nom tel que 'capture'.
  649.  
  650.  Lorsque vous aurez terminé la prise (avez-vous pensé à prendre les 
  651.  fichiers de corrections éventuels déjà dans la BBS?), vous devez
  652.  extraire les fichiers 7PLUS du fichier de capture. Un éditeur permettra
  653.  cela ou -bien plus simple- 7PLUS lui-même! 7PLUS extrait les fichiers
  654.  utiles mais de plus donnera les noms corrects à ces fichiers.
  655.  
  656.  En invoqant 7PLUS de la manière suivante: '7plus capture -x' vous
  657.  obtiendrez les différents fichiers encodés 7plus du fichier de 
  658.  capture.
  659.  
  660.  Maintenant les fichiers sont sous format 7PL et vous procéderez au
  661.  décodage.
  662.  
  663.  Voyons ce que nous avons sur disque maintenant:
  664.   (ceci est un exemple)
  665.  
  666.   TERM952.P01
  667.   TERM952.P02
  668.   TERM952.P03
  669.   TERM952.P04
  670.   TERM952.COR
  671.  
  672.  
  673.   Ah, bon....Vous avez pensé à retirez le fichier de correction qui se
  674.   trouvait déjà dans la BBS.
  675.  
  676.   Il y a deux façons de décoder ces fichiers:
  677.  
  678.   '7plus term952.cor'  <--- Fera la correction.
  679.   '7plus term952.p01'  <--- Decodage.
  680.  
  681.   ou
  682.  
  683.   '7plus term952'      <--- 7PLUS travaillera de par lui-même.
  684.  
  685.   Soyez prudent, la deuxième procédure, si un fichier 'term952' existe 
  686.   déjà dans le répertoire, 7PLUS ne décodera pas 'term952.p01', mais
  687.   encodera 'term952'! Ceci est la raison pour laquelle je vous 
  688.   conseillais d'utiliser un nom différent pour le fichier de capture,
  689.   nom qui n'aura pas de ressemblances avec le nom des fichiers encodés
  690.   sous 7PLUS.
  691.  
  692.   Si le décodage s'est bien déroulé, 7PLUS donnera le message suivant:
  693.  
  694.   'Decoding succesful! 'term952.exe' 43210 Bytes.'
  695.  
  696.   TERM952.EXE est le fichier décodé. Ce qu'il vous reste à faire
  697.   maintenant dépendra des indications de l'expéditeur du fichier.
  698.   Comme auteur de 7PLUS, je n'ai plus ici à ce stade, d'autorité.
  699.  
  700.   Si le décodage n'a pas réussi.
  701.  
  702.   7PLUS donnera:
  703.  
  704.   'Decoding not successful.
  705.    Send error report 'term952.err' to originator of 'term952.exe'
  706.    for correction.'
  707.  
  708.   Ceci signifie simplement, que vous devez envoyer le fichier 'term952.err'
  709.   à l'expéditeur du fichier 'term952.exe' et d'attendre son envoi d'un
  710.   fichier de correction.
  711.  
  712.   De par le passé, il est arrivé que certains OM's m'envoient des fichiers
  713.   d'erreurs afin d'obtenir des fichiers de corrections, pour des fichiers
  714.   dont je n'étais pas l'expéditeur original. Laissez-moi vous dire encore
  715.   clairement: LE responsable des corrections est celui qui a mis au départ
  716.   le fichier endommagé et c'est à cette OM que vous devez aussi envoyer
  717.   vos fichiers d'erreurs. Je ne suis que l'auteur de l'encodeur/décodeur et
  718.   n'ai donc rien à voir avec la suite des évenements. Une comparaison:
  719.   Une agence de livraison livre des colis endommagés lors du transport.
  720.   Personne n'aura l'idée d'attaquer le fabricant du camion (moi) qui a 
  721.   transporté les colis, si le camion (7PLUS) est en bon état mais que
  722.   le réseau routier (le réseau packet) est mauvais....
  723.  
  724.  
  725.   Comment mettre des fichiers 7PLUS sur une BBS:
  726.   ==============================================
  727.  
  728.   Comme déjà dit au chapitre précédent, assurez-vous que votre logiciel
  729.   de comunication et votre tnc soient configurés correctement afin de
  730.   permettre le traitement de fichiers sous 7PLUS. Si vous ne prenez pas
  731.   toutes ces précautions, il se pourrait que les fichiers encodés ne soient
  732.   pas décodables. Evitez de frustrer les autres usagers.
  733.  
  734.   Il est bon d'écrire un petit texte explicatif, dans lequel vous 
  735.   indiquerez le type de logiciel compris dans vos fichiers. Indiquez le
  736.   système informatique pour lequel le logiciel est prévu ainsi que
  737.   l'archiveur utilisé (LHARC, LHA, PKZIP....), ainsi que les noms des
  738.   fichiers faisant partie de l'ensemble et surtout faites mention du
  739.   type d'encodeur (en ce cas 7PLUS). Comme ceci le lecteur pourra se
  740.   rendre compte immédiatement si le logiciel lui sera d'une quelconque
  741.   utilité. Le titre de cette info sera brêve mais claire:
  742.   
  743.     p.ex: 'TERM952.EXE Info'
  744.  
  745.   Lors de l'envoi vers la BBS, indiquez aussi pour quel système informatique
  746.   le logiciel est prévu:
  747.  
  748.     'TERM952.EXE Info (IBM)'
  749.  
  750.   OK, maintenant vous pouvez procédez à l'encodage. Certains sysops
  751.   limitent la taille des fichiers acceptés sur les BBS. Informez-vous.
  752.   Prenez cela en compte lors de l'utilisation des options '-s' et '-sp'.
  753.  
  754.   Supposons que TERM952.EXE fasse 43210 bytes. Lors de l'encodage, la 
  755.   longueur du fichier augmentera de 11% soit 48k. Supposons aussi que
  756.   la longueur maximale des fichiers sur cette BBS est de 4k. Vous
  757.   devrez donc encoder en 12 parties en utilisant l'option '-sp' ou en
  758.   blocs de +- 4k en utilisant l'option '-s 60'.
  759.  
  760.   '7plus term952.exe -sp 12' ou
  761.   '7plus term952.exe -s 60'
  762.  
  763.   OK, l'encodage est terminé. Vous avez donc les fichiers 'TERM952.P01'
  764.   à 'TERM952.P0C' (numérotation hexadécimale) sur disque. Les fichiers
  765.   peuvent être transmis maintenant séparémment vers la BBS. Ici aussi,
  766.   utilisez un titre explicatif et clair:
  767.  
  768.   'TERM952.P01 / 0C (7PLUS)'
  769.  
  770.   Ceci veut dire: TERM952 est encodé sous 7PLUS et ce fichier est le
  771.   premier de 12 parties (0C hexa).
  772.  
  773.   Mieux encore, mais plus rébarbatif pour les novices:
  774.  
  775.   'TERM952.EXE.P01/0C.7PL'
  776.  
  777.   La meilleure façon de lire ce dernier, est à l'envers:
  778.    C'est un fichier sous 7PLUS, premier de 12 parties et le fichier encodé
  779.    est TERM952.EXE.
  780.  
  781.   Après avoir mis tous les fichiers dans la BBS, une vérification peut
  782.   se faire de la façon suivante, vous reprenez de la BBS vos fichiers et
  783.   vous tentez le décodage en sens inverse. Si vous recevez des erreurs
  784.   vous saurez immédiatemment créer le fichier de correction ad-hoc et le
  785.   mettre à disposition des OM's dans la BBS.
  786.  
  787.   Maintenant il vous reste à attendre les fichiers d'erreurs....
  788.  
  789.  7PLUS peut être compilé sur IBM-PC, ATARI ST et AMIGA. Voir 
  790.  les notes dans le code source.
  791.  
  792.  
  793.  7PLUS est écrit pour un usage radio-amateur et de ce fait
  794.  gratuit. Il peut être distribué gratuitement et copié
  795.  librement, mais cela uniquement dans son intièreté c'est-à-dire 
  796.  comprenant le code source et les documentations.
  797.  L'utilisation de 7PLUS dans un environnement commercial est 
  798.  interdit et aucun droit d'utilisation ne peut être perçu.
  799.  
  800.  
  801.  73's Axel Bremerhaven, DG1BBQ @ DB0CL.DEU.EU
  802.  
  803.  (Traduction de ON7LE @ ON7RC.BEL.EU)
  804.  
  805.